Manage orders - Gets a product promotion by id.
依標識碼取得促銷詳細數據。
GET https://api.partnercenter.microsoft.com/v{version}/productpromotions/{id}
GET https://api.partnercenter.microsoft.com/v{version}/productpromotions/{id}?country={country}
URI 參數
| 名稱 | 位於 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
id
|
path | True |
string |
升級標識碼。 |
|
version
|
path | True |
string |
|
|
country
|
query |
string |
國家/地區代碼。 |
要求標頭
| 名稱 | 必要 | 類型 | Description |
|---|---|---|---|
| Authorization | True |
string |
授權持有人令牌 |
| ms-correlationid |
string |
用於在內部追蹤要求。 如果未提供 ms-correlationid,伺服器會為每個要求產生新的要求 |
|
| MS-CV |
string |
用於在內部追蹤要求。 如果未提供 MS-CV,伺服器將會為每個要求產生新的要求 |
|
| ms-requestid |
string |
用於要求等冪性。 如果未提供 ms-requestid,伺服器將會為每個要求產生新的要求 |
回應
| 名稱 | 類型 | Description |
|---|---|---|
| 200 OK |
要求成功。 回應本文將包含促銷詳細數據。 Media Types: "application/json", "text/json", "application/xml", "text/xml" |
|
| 400 Bad Request |
輸入遺失或無效。 回應本文會提供錯誤詳細數據。 Media Types: "application/json", "text/json", "application/xml", "text/xml" |
|
| 401 Unauthorized |
要求未通過驗證。 客戶端必須先向合作夥伴 API 服務進行驗證。 Media Types: "application/json", "text/json", "application/xml", "text/xml" |
|
| 403 Forbidden |
要求已通過驗證,但因為呼叫端沒有叫用要求的許可權而遭到拒絕。 Media Types: "application/json", "text/json", "application/xml", "text/xml" |
|
| 404 Not Found |
找不到資源,或無法使用指定的輸入參數。 Media Types: "application/json", "text/json", "application/xml", "text/xml" |
|
| 500 Internal Server Error |
合作夥伴 API 服務或其其中一個相依性無法滿足要求。 Media Types: "application/json", "text/json", "application/xml", "text/xml" |
定義
Contracts.V1.Models.ProductPromotion
| 名稱 | 類型 | Description |
|---|---|---|
| description |
string |
|
| endDate |
string (date-time) |
|
| id |
string |
|
| name |
string |
|
| properties | ||
| requiredProducts | ||
| startDate |
string (date-time) |
Contracts.V1.Models.ProductPromotionPricingPolicy
| 名稱 | 類型 | Description |
|---|---|---|
| policyType |
string |
|
| value |
string |
Contracts.V1.Models.ProductPromotionProperties
| 名稱 | 類型 | Description |
|---|---|---|
| isAutoApplicable |
boolean |
Contracts.V1.Models.ProductPromotionRequiredProduct
| 名稱 | 類型 | Description |
|---|---|---|
| pricingPolicies | ||
| productId |
string |
|
| skuId |
string |
|
| term |
Contracts.V1.Models.ProductPromotionTerm
| 名稱 | 類型 | Description |
|---|---|---|
| billingCycle |
string |
|
| duration |
string |